.\"   $Id: dellocap.3,v 1.1 2002/08/14 21:47:47 pnt Exp $
.\" @(#)dellocap.2 2.11 91/08/22 ; Labo LIP6/ASIM cao-vlsi; Author : Pierre Nguyen Tuong
.if t \{\
.so man1/alc_contents.mac
.XS \n%
.ti 0.2i
dellocap
.XE
.XS2 \n%
.ti 0.2i
dellocap
.XE2 \}
.TH DELLOCAP 3 "August 14, 2002" "ASIM/LIP6" "MBK LOGICAL FUNCTIONS"
.SH NAME
dellocap \- delete a logical capacitor
.so man1/alc_origin.1
.SH SYNOPSIS
.nf
.if n \{\
.ft B \}
.if t \{\
.ft CR \}
#include "mlo.h"

int dellocap(ptfig,ptcap)
lofig_list \(**ptfig ;
locap_list \(**ptcap ;
.ft R
.fi
.SH PARAMETERS
.TP 20
\fIptfig\fP
Pointer to the figure in which the capacitor should be deleted
.TP
\fIptcap\fP
Pointer to the capacitor to be deleted.
.SH DESCRIPTION
\fBdellocap\fP delete the capacitor pointed to by \fIptcap\fP in the figure 
pointed to by \fIptfig\fP. 
The list consistency is maintainded, and the space freed. The capacitor
connectors are also freed, since if the capacitor disappear,
no more connections can occur on it.
.SH RETURN VALUE
\fBdellocap\fP returns \fB1\fP if the capacitor has been deleted, \fB0\fP
if the capacitor pointer does not exists in the list.
.SH EXAMPLE
.ta 3n 6n 9n 12n 15n 18n 21n
.nf
.if n \{\
.ft B \}
.if t \{\
.ft CR \}
#include "mlo.h"

char \(**was_existing(lofig_list \(**ptfig,locap_list \(**ptcap)
{
  return dellocap(ptfig,ptcap) ? "you just killed it!" : "wasn't here anyway" ; 
}
.ft R
.fi
.SH SEE ALSO
.BR mbk (1),
.BR lofig (3),
.BR locap (3),
.BR addlocap (3).


.so man1/alc_bug_report.1

